OLA 文档中心

主题

2026-09-28

绑定窗口高级 - BindWindowEx ​

函数简介 ​

绑定指定的窗口，并指定屏幕颜色获取方式、鼠标仿真模式、键盘仿真模式、通用模式以及模式设定。

支持绑定沙盒程序（如 Sandboxie-Plus / 经典 Sandboxie）。若目标在沙盒内运行时出现绑定失败或 IPC 受限，可在沙盒配置（例如 Templates.ini 或当前沙盒的 Sandboxie.ini 中对应条目）的 [GlobalSettings] 段追加 OpenIpcPath 配置。路径中的 * 为沙盒通配符（匹配包含该片段的路径）；请按实际要放行的进程名或路径修改其中的 TSVN 片段。可以通过SetConfig中的SharedMemoryNamePrefix来修改IPC前缀

配置示例：

ini
[GlobalSettings]
OpenIpcPath=*TSVN*

管理员权限：全局配置 EnsureElevated 默认为 true 时，本接口要求当前进程已 UAC 提升（管理员权限），否则绑定失败并返回 -4004。绑定前可用 IsElevated 检测；若需关闭此限制，可通过 SetConfigByKey 设置 EnsureElevated=false（详见 SetConfig）。

失败时返回值为负数，绝对值为错误码，详见 BindWindow 错误码说明。

接口名称 ​

BindWindowEx

DLL调用 ​

int BindWindowEx(long ola, long hwnd, string display, string mouse, string keyboard, string public, int mode);

参数说明 ​

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
hwnd长整数型指定的窗口句柄。display 含 "camera" 时可为 0，且不会被改成桌面句柄。
display字符串屏幕颜色获取方式，详见下方说明。
mouse字符串鼠标仿真模式，详见下方说明。
keyboard字符串键盘仿真模式，详见下方说明。
public字符串通用绑定模式，详见下方说明。
mode整数型模式设定，详见下方说明。

display 屏幕颜色获取方式 ​

值说明
"normal"正常模式，前台截屏模式。
"gdi"GDI模式。
"gdi2"GDI2模式，兼容性较强但速度较慢。
"gdi3"GDI3模式，兼容性较强但速度较慢。
"gdi4"GDI4模式，支持小程序和浏览器截图。
"gdi5"GDI5模式，支持小程序和浏览器截图。
"dxgi"DXGI模式，支持小程序和浏览器截图，Windows10 1903及以上版本支持。
"dx.graphic.2d"dx.graphic.2d模式。
"dx.graphic.2d.2"dx.graphic.2d.2模式。
"dx.graphic.2d.3"dx.graphic.2d.3模式。
"dx.graphic.native"支持雷电模拟器,mumu模拟器后台截图原始数据。
"camera"绑定本机摄像头或 OBS Virtual Camera。hwnd 可为 0。设备与分辨率走 SetConfig 的 Camera*，详见下方「摄像头绑定」。public 不解析摄像头参数。不注入 Hook，且不要求管理员权限。
"vnc"VNC模式 (需要SetConfig接口中设置虚拟机端口)。
"dx"DX模式 (需要管理员权限)。
"vmware"虚拟机模式 (需要管理员权限。高级版功能，普通版无法使用)。

摄像头绑定（display=camera） ​

display 含 camera 时，画面来自本机摄像头，后续 Capture / FindPic 的坐标相对画面左上角。全图截图可传 0,0,0,0。hwnd 可为 0，不会被改成桌面句柄。

public 不解析摄像头设备或分辨率。上下翻转用 dx.public.graphic.revert。键鼠模式仍须是合法值，常用 "normal" / "normal"。本模式不注入 Hook，也不做 EnsureElevated 的管理员校验。

摄像头参数只从 SetConfig / SetConfigByKey 读取，绑定时生效。改配置后需要重新绑定。

配置项说明
CameraIndex设备索引，默认 0。CameraName 非空时忽略。
CameraName友好名，支持 OBS Virtual Camera。空则用 CameraIndex。
CameraWidth / CameraHeight请求像素宽高。0 表示设备默认。
CameraFps请求帧率。0 表示设备默认。
CameraFourcc请求 FOURCC（MJPG / YUY2 / NV12 等）。空表示不指定。
CameraStricttrue 时请求宽高与实际不一致则绑定失败，返回 -4102。只比较宽高。
CameraBindTimeoutMs打开摄像头最大等待（毫秒），默认 8000。0 等同 8000。超时返回 -4104。

绑定前用 EnumCameras 看驱动报告的规格。绑定后：

cpp
ola.SetConfig("{\"CameraIndex\":0,\"CameraWidth\":1920,\"CameraHeight\":1080,"
              "\"CameraFps\":30.0,\"CameraFourcc\":\"MJPG\"}");
int ret = ola.BindWindowEx(0, "camera", "normal", "normal", "", 0);
ola.Capture(0, 0, 0, 0, "cam.png");

失败返回负数，摄像头相关为 -4101～-4104，见 BindWindow 错误码说明。

视频句柄路径（OpenCamera / OpenCameraEx）与这次绑定相互独立。只要读帧、不要当截图源时，用 视频处理 的打开接口。

mouse 鼠标仿真模式 ​

值说明
"normal"正常模式，前台鼠标模式。
"windows"Windows模式，模拟windows消息。
"windows3"Windows3模式，模拟windows消息，适用于多窗口的进程。
"vnc"VNC模式 (需要SetConfig接口中设置虚拟机端口)。

dx模式组合（使用 | 连接）：

值说明
"dx.mouse.position.lock.api"通过API锁定鼠标位置。
"dx.mouse.position.lock.message"通过消息锁定鼠标位置。
"dx.mouse.focus.input.api"通过API锁定鼠标输入焦点。
"dx.mouse.focus.input.message"通过消息锁定鼠标输入焦点。
"dx.mouse.clip.lock.api"通过API锁定刷新区域。
"dx.mouse.input.lock.api"通过API锁定鼠标输入接口。
"dx.mouse.state.api"通过API锁定鼠标输入状态。
"dx.mouse.state.message"通过消息锁定鼠标输入状态。
"dx.mouse.api"通过API模拟DX鼠标输入。
"dx.mouse.cursor"后台获取鼠标特征码。
"dx.mouse.raw.input"特殊窗口鼠标操作支持。
"dx.mouse.input.lock.api2"前台鼠标移动控制。
"dx.mouse.input.lock.api3"前台鼠标移动控制。
"dx.mouse.raw.input.active"配合raw.input的后台支持。
"dx.mouse.vmware"虚拟机鼠标穿透模式，目前只支持vm16、vm17 (高级版功能，普通版无法使用)。

keyboard 键盘仿真模式 ​

值说明
"normal"正常模式，前台键盘模式。
"windows"Windows模式，模拟windows消息。
"vnc"VNC模式 (需要SetConfig接口中设置虚拟机端口)。

dx模式组合（使用 | 连接）：

值说明
"dx.keypad.input.lock.api"通过API锁定键盘输入接口。
"dx.keypad.state.api"通过API锁定键盘输入状态。
"dx.keypad.api"通过API模拟DX键盘输入。
"dx.keypad.raw.input"特殊窗口键盘操作支持。
"dx.keypad.raw.input.active"配合raw.input的后台支持。
"dx.keypad.api2"新的后台模拟形式。
"dx.keypad.vmware"虚拟机键盘穿透模式，目前只支持vm16、vm17 (高级版功能，普通版无法使用)。

public 通用绑定模式 ​

值说明
"dx.public.graphic.revert"翻转 DX 或 camera 截图（上下颠倒）。
"dx.public.active.api"自动定时发送激活命令。
"dx.public.active.api2"自动定时发送激活命令2。
"dx.public.active.api3"修改激活态方案。
"dx.public.active.message"通过消息激活窗口；可与 dx.public.active.api 组合，供后台窗口收字。
"dx.public.input.ime"配合 SendStringIme 以 IME 组合结果向绑定窗口发文本。
"ola.bypass.guard"绑定失败时可以尝试打开。
"ola.public.memory.protect"高级版无痕绑定功能 (高级版功能，普通版无法使用)。
"ola.public.memory.protect2"高级版无痕绑定功能 (高级版功能，普通版无法使用)。
"dx.public.down.cpu"配合 DownCpu type=0：消息循环无消息时 Sleep；不可与 DownCpu type=1 同时使用。

mode 模式设定 ​

值说明
0推荐模式，通用性最好，后台效果最佳。
1远程线程注入。
2驱动注入模式1，当0、1无法使用时使用；内置欧拉驱动会自动加载。
3驱动注入模式2，当0、1无法使用时使用；内置欧拉驱动会自动加载。
4驱动注入模式3，当0、1无法使用时使用；内置欧拉驱动会自动加载。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long hwnd = ola.FindWindow("", "记事本");
if (hwnd != 0) {
int ret = ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0);
if (ret == 1) {
    // 操作成功
}
}
csharp
using OLAPlug;

var ola = new OLAPlugServer();
long hwnd = ola.FindWindow("", "记事本");
if (hwnd != 0)
{
int ret = ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0);
if (ret == 1)
{
    // 操作成功
}
}
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
hwnd = ola.FindWindow("", "记事本")
if hwnd != 0:
    ret = ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0)
    if ret == 1:
    pass  # 操作成功
}
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
long hwnd = ola.FindWindow("", "记事本");
if (hwnd != 0) {
int ret = ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0);
if (ret == 1) {
    // 操作成功
}
}
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
hwnd := ola.FindWindow("", "记事本")
if hwnd != 0 {
ret := ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0)
if ret == 1 {
    // 操作成功
}
}
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let hwnd = ola.find_window("", "记事本");
if hwnd != 0 {
let ret = ola.bind_window_ex(&hwnd, "normal", "normal", "normal", "", 0);
if ret == 1 {
    // 操作成功
}
}
cpp
var ola = com("OlaPlug.OlaSoft")
var hwnd = ola.FindWindow("", "记事本")
if(hwnd) {
var ret = ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0)
if(ret == 1) {
    // 操作成功
}
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
hwnd = ola.FindWindow("", "记事本")
If hwnd <> 0 Then
ret = ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0)
If ret = 1 Then
    ' 操作成功
End If
End If
text
.局部变量 ola, OLAPlug
ola.创建 ()
hwnd ＝ ola.FindWindow (“”, “记事本”)
.如果真 (hwnd ≠ 0)
ret ＝ ola.BindWindowEx(hwnd, “normal”, “normal”, “normal”, “”, 0)
.如果真 (ret ＝ 1)
    ' 操作成功
.如果真结束
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var hwnd = ola.FindWindow("", "记事本");
if(hwnd){
var ret = ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0);
if(ret == 1){
    // 操作成功
}
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 hwnd = ola.FindWindow ("", "记事本")
如果真 (hwnd ≠ 0)
{
整数 ret = ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0)
如果真 (ret ＝ 1)
{
    // 操作成功
}
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int64_t hwnd = ola.FindWindow("", "记事本");
if (hwnd != 0) {
int32_t ret = ola.BindWindowEx(hwnd, "normal", "normal", "normal", "", 0);
if (ret == 1) {
    // 操作成功
}
}

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
long hwnd = 0; // 目标窗口句柄
BindWindowEx(instance, hwnd, "normal", "normal", "normal", "", 0);
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int BindWindowEx(long ola, long hwnd, string display, string mouse, string keyboard, string public, int mode);

long instance = CreateCOLAPlugInterFace();
long hwnd = 0;
BindWindowEx(instance, hwnd, "normal", "normal", "normal", "", 0);
python
from ctypes import CDLL, c_int, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
ola.BindWindowEx(instance, hwnd, "normal", "normal", "normal", "", 0)

返回值 ​

返回值说明
1成功。
负数失败；绝对值为错误码（如 -4032 表示 RemoteExe 注入失败）。与 GetLastError() 一致。
-1001权限不足 / 未登录。
-1004VMware 权限不足。
-4004需要管理员权限（EnsureElevated=true 且未 UAC 提升）。

完整错误码表见 BindWindow 错误码说明。

失败时可调用 GetLastErrorString() 获取中文说明。

注意事项 ​

项目说明
管理员权限全局 EnsureElevated 默认 true：未以管理员权限（UAC 已提升）运行则绑定失败，返回 -4004。display 含 "camera" 时不做这项校验。部分 display/mode 组合（如 "dx"、"vmware"）本身也依赖提升权限。
EnsureElevated设置为 false 可关闭绑定前的管理员校验（见 SetConfigByKey / SetConfig）。
IsElevated建议绑定前调用 IsElevated，返回 1 表示已提升。
DownCpu绑定 DX 图色后可用 DownCpu 降低目标进程 CPU；dx.public.down.cpu 会改变 type=0 行为，且不可与 type=1 同时使用。
默认 Callmode=11/12 的远程执行入口受 SetMemoryCallMode 影响；mode=1 固定 CreateRemoteThread + LoadLibrary，不受影响。
IME 发字SendStringIme 要求 public 含 dx.public.input.ime。SendStringIme2 须在 Bind 之前 mode=200 安装通道；后台不收字时可加 dx.public.active.api|dx.public.active.message。
摄像头display="camera" 的设备、分辨率、帧率、FOURCC 只走 SetConfig 的 Camera*。hwnd 可为 0。绑定后用 GetBindCameraInfo 或 GetClientSize 读实际像素大小。